Skip to content

Add C to Rust Migration course landing page#2865

Open
avollrath wants to merge 42 commits into
masterfrom
rust-exercises-page
Open

Add C to Rust Migration course landing page#2865
avollrath wants to merge 42 commits into
masterfrom
rust-exercises-page

Conversation

@avollrath

@avollrath avollrath commented Jun 4, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds a new landing page for the C to Rust Migration course at /c-to-rust-migration-book/.

TODO

  • @marcoow to connect the Mailchimp audience to the subscription form
  • @marcoow to add the links to the actual material and PDF
  • @avollrath add og:image
  • @avollrath replace HTML and PDF once mainmatter/migrating-c-to-rust#8 is fixed
  • @marcoow finalize copy (look at my comments)

@marcoow

marcoow commented Jun 12, 2026

Copy link
Copy Markdown
Member

This seems broken now?

Bildschirmfoto 2026-06-12 um 11 50 19

@avollrath

Copy link
Copy Markdown
Contributor Author

@marcoow

The slug in the PR description wasn't updated from the previous version (now it is), it should be /c-to-rust-migration/, so the working preview is here:

https://deploy-preview-2865--objective-northcutt-37494c.netlify.app/c-to-rust-migration/

I still need to address Linn's latest comments from Notion though.

@marcoow

marcoow commented Jun 12, 2026

Copy link
Copy Markdown
Member

I think it looks good!

@marcoow marcoow left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Your Mentor" makes sense for workshops but "Your author" sounds a bit strange

Comment thread src/c-to-rust-migration-lp.njk Outdated
Comment thread src/c-to-rust-migration-lp.njk Outdated
avollrath and others added 3 commits June 12, 2026 13:55
Co-authored-by: Marco Otte-Witte <marco.otte-witte@mainmatter.com>
Co-authored-by: Marco Otte-Witte <marco.otte-witte@mainmatter.com>
Comment thread src/c-to-rust-migration-lp.njk Outdated
avollrath and others added 3 commits June 15, 2026 19:30
Co-authored-by: Marco Otte-Witte <marco.otte-witte@mainmatter.com>

@marcoow marcoow left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think the "by Mainmatter" needs to be closer to the headline (like it's here: https://rust-exercises.com) – otherwise it looks strange:

Image

Should we have some kind of grid for these links so they don't look as unaligned?

Image

I think it would be nice to have a larger image of Jonas (I know this is an existing component but still):

Image

Is the arrow not on the wrong side?

Image

I'll look into copy on Friday

Comment thread src/c-to-rust-migration-lp.njk Outdated
Comment thread src/c-to-rust-migration-lp.njk Outdated
Comment thread src/c-to-rust-migration-lp.njk Outdated
Comment thread src/c-to-rust-migration-lp.njk
Comment thread src/c-to-rust-migration-lp.njk Outdated
Comment thread src/c-to-rust-migration-lp.njk
Comment thread src/c-to-rust-migration-lp.njk Outdated
Comment thread src/c-to-rust-migration-lp.njk Outdated
Comment thread src/c-to-rust-migration-lp.njk Outdated
@mainmatterlinnbp

Copy link
Copy Markdown
Contributor

@marcoow I added the Mailchimp audience "Mainmatter C to Rust", so please use that for the sign-up form. I set it up as a duplicate based on the Rust audience, feel free to make any changes you see fit directly in Mailchimp.

@marcoow

marcoow commented Jun 22, 2026

Copy link
Copy Markdown
Member

@avollrath @mainmatterlinnbp we should think about where and how this page is linked from the rest of mainmatter.com. If you get to this and navigate away, there should be a way to find it again?

@JonasKruckenberg

Copy link
Copy Markdown
Contributor

@avollrath @marcoow I pushed a change with my suggestions for improved copy, please have a look!

Comment thread src/c-to-rust-migration-lp.njk Outdated
@marcoow

marcoow commented Jun 26, 2026

Copy link
Copy Markdown
Member

Thanks @JonasKruckenberg. Looks good to me overall, I'll make the copy a bit smoother next week.

@marcoow marcoow force-pushed the rust-exercises-page branch from 61163ba to 9056487 Compare June 30, 2026 06:34
@marcoow

marcoow commented Jun 30, 2026

Copy link
Copy Markdown
Member

@avollrath can you finish the above task for you?

@marcoow marcoow left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@avollrath I think it would be nice to keep the book illustration on mobile (I understand we want to save space but at least a small version would be good):

Image

@marcoow

marcoow commented Jun 30, 2026

Copy link
Copy Markdown
Member

the crawler should go green once the GH repo is open-sourced and we remove the custom mdbook theme

@marcoow marcoow left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This doesn't look polished yet tbh:

Image

@avollrath

Copy link
Copy Markdown
Contributor Author

@avollrath do you know why https://deploy-preview-2865--objective-northcutt-37494c.netlify.app/c-to-rust-migration/ still works (but the page it renders is outdated/broken) when it should be https://deploy-preview-2865--objective-northcutt-37494c.netlify.app/c-to-rust-migration-book/ (see https://github.com/mainmatter/mainmatter.com/pull/2865/changes#diff-3102876604bb31137f347378af10d53f6a5154ea54b03f8662eae94686df7881R5)

Could it be because the repo build writes into dist without cleaning old generated pages? Then the old slug could still exist after the permalink changed.

I’m not sure whether this is preview-specific or also possible for production without seeing the Netlify logs. Has this come up before with other permalink changes?

@avollrath

Copy link
Copy Markdown
Contributor Author

This doesn't look polished yet tbh:

Image

@marcoow Better as a flyout menu?

image

@marcoow

marcoow commented Jun 30, 2026

Copy link
Copy Markdown
Member

ok, redeploy with emptied cache fixed it

@marcoow

marcoow commented Jun 30, 2026

Copy link
Copy Markdown
Member

I guess having it inline works as well but the menu shouldn't change it's width when the learning materials are expanded and we should animate the arrows as we do elsewhere

@avollrath

Copy link
Copy Markdown
Contributor Author
Screen.Recording.2026-06-30.at.15.58.48.mov

@marcoow If we want to keep it inline and with the same width, it comes with the tradeoff that that space needs to be reserved beforehand in the main menu -> so that's wider by default now. The caret icon ^ behaves the same as in the main menu (next to "More"), just flipping up and down.
I added subtle animation for the nested items appearing and the menu vertically expanding, so it feels a bit smoother.

What do you think about this version?

@marcoow

marcoow commented Jun 30, 2026

Copy link
Copy Markdown
Member

I think this is better – stuff jumping around just isn't great. Should we not animate the caret as well?

@avollrath

Copy link
Copy Markdown
Contributor Author

@marcoow

100%, no jumping is much better.

I've now done those adjustments:

  • Added animations for the carets, nested menu items, and a quick overall menu opening animation (Had to use js for the nested menu animation because Safari does not reliably animate it smoothly with css only (animation is still just css transitions though))
  • Reduced hero toc font size so it fits on a single line
  • Added the books as a background for the mobile CTA block

I also made a those changes earlier:

  • Increased Jonas' author image
  • Switched the arrow position in the "Contact us" row
  • Moved the "by Mainmatter" label closer to the title

I think that covers everything I was pinged for (Jonas updated html and pdf with the latest version today)

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants